home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / mkey108.zip / MAGICKEY.DOC < prev    next >
Text File  |  1994-06-30  |  26KB  |  602 lines
  1.  
  2.  
  3. MagicKey                                                 Version 1.08
  4.  
  5.  
  6.             (c) Copyright 1994 Jennings Communications, Inc
  7.  
  8.  
  9. MagicKey was originally created as a kind of on-line address book that
  10. could be popped up in an editor or terminal to fill in email addresses
  11. automatically. But it can be used to TYPE ANY TEXT INTO ANY PROGRAM.
  12.  
  13. I use it to save all my favorite telnet, finger, and ftp addresses as
  14. well as email addresses for use on-line in a terminal program or off-line
  15. creating new mail.
  16.  
  17. The ability to add new lines at any time means I can add new services to
  18. the list as I am reading about news or mail about them and later,
  19. when I have the time, I can try them out. Kind of a TO DO list for commands
  20. I want to execute later.
  21.  
  22. Being able to capture text directly from the screen means I no longer end
  23. up with typos in long strings of subdirectories or URLs. It is very easy
  24. to clip long ftp site names and store them into PERSONAL.DAT for later use.
  25.  
  26. It would work just as well as a popup DOS menu program for selecting from a
  27. menu of DOS commands.
  28.  
  29. Or, it can be used to fill in mailing labels with stored names and addresses.
  30.  
  31. Programmers will use it to type functions directly into programs and then
  32. just edit the arguments as necessary.
  33.  
  34. You can even use MagicKey in conjunction with a modem as a Rolodex type
  35. phone directory with instant dialing.
  36.  
  37. When you press the hotkey combination a scrollable window is popped up
  38. containing a description on the left and a string on the right. Scroll
  39. the highlight bar to the desired item and press Enter to auto-type the
  40. desired string. Pretty simple.
  41.  
  42. There is no limit to the number of strings that can be stored. The window
  43. displays a plain ascii text file that can be as large as your hard disk
  44. will allow. You can use any editor to add or modify strings at any time.
  45.  
  46. Navigation is done using the usual cursor movement keys. Pressing a
  47. letter will scroll rapidly to that part of the file (if it has been sorted
  48. into alphabetical order). Subsequent letters will index further.
  49.  
  50. Multiple line entries can be auto-typed by repeatedly popping up MagicKey
  51. and pressing Enter. The cursor will automatically advance each time.
  52.  
  53. A tree of menu files can be created using MagicKey's ability to change
  54. files at any time by selecting a line containing a file name.
  55.  
  56. MagicKey is a text based application. It cannot be used with Windows, or
  57. popped up in a program which has switched the display to graphics mode.
  58.  
  59.  
  60.  
  61.    ┌─────────────────────────────────────────────────────────────────┐
  62.    │                                                                 │
  63.    │   The latest version of MagicKey and data is available from:    │
  64.    │                                                                 │
  65.    │             ftp.netcom.com:/pub/VE3SUN/mkey*.exe                │
  66.    │                                                                 │
  67.    └─────────────────────────────────────────────────────────────────┘
  68.  
  69.  
  70. Even if you don't register, please let us know if you have any suggestion
  71. or comments on the program. If you are not registering because there is a
  72. feature that you expected or wanted that wasn't there, please tell us so we
  73. can continue to improve this product.
  74.  
  75. ────────────────────────────────────────────────────────────────────────────
  76.  
  77.  
  78. INSTALLATION
  79.  
  80. Quick Demo
  81. ----------
  82. If you want to move the sample data to c:\MAGIC and run MagicKey, use:
  83.  
  84. > INSTALL
  85.  
  86. This BAT file will copy all of the files to the c:\MAGIC directory.
  87. You may use another directory name, but it will be necessary to
  88. modify the filenames embedded in the reference files using a
  89. plain text editor.
  90.  
  91. Change the file names in {} brackets to the appropriate full pathname for
  92. your installation. E.g. {c:\magic\INTERNET.DAT} could become
  93. {e:\internet\internet.dat} if you have installed the data files in
  94. the directory INTERNET on drive E:
  95.  
  96. ────────────────────────────────────────────────────────────────────────────
  97.  
  98. Operation
  99. ---------
  100. The program MAGICKEY.EXE installs the MagicKey TSR in your computer's
  101. memory.  If you want to have MagicKey available at all times, you can add
  102. the installation lines to your AUTOEXEC.BAT file.  If so, you will probably
  103. want to use LOADHIGH or \QEMM\LOADHI, or some similar memory management
  104. utility to load MagicKey into extended memory. Test MAGICKEY on your system
  105. in conjunction with other programs before adding it to your AUTOEXEC.BAT.
  106. MagicKey takes about 52K when loaded into conventional memory.
  107.  
  108. If you only want to install MagicKey for use while a certain program is
  109. running, or if you want to install MagicKey with a different data file for
  110. each program, the easiest way is to create a BATCH file which will install
  111. MagicKey, run your program, and uninstall MagicKey when you are done.
  112.  
  113. ────────────────────────────────────────────────────────────────────────────
  114.  
  115. Command Line arguments
  116. ----------------------
  117.  
  118. C:> MAGICKEY [data-file] [-k[=nn,nn]] [-t] [-r]
  119.  
  120.  
  121. MAGICKEY.EXE  is the program which installs the TSR.
  122.  
  123. data-file is a text file containing the descriptions and the automatic
  124.           strings. If it is in the same directory as the MAGICKEY.EXE
  125.           program, only the file name is required. If it is in a different
  126.           directory, it is necessary to use the entire path name including
  127.           the drive and directories. [ e.g. C:\MAGIC\INTERNET.DAT  ]
  128.  
  129. - or /    Options may be indicated with - or / according to your taste.
  130.           Case is ignored.
  131.  
  132. -k        An optional method of defining your own hotkey. The default is
  133. /K        Alt-Left-Shift-A.  That is, hold down Alt. Hold down the Left
  134.           Shift key, and press the A key. That is very easy on my keyboard,
  135.           but you may prefer a different key combination that fits your
  136.           fingers and keyboard.
  137.  
  138.           If you just use -K ( or /K ) as an argument, MagicKey will
  139.           prompt for the key combination you wish to use. If the
  140.           combination you try is a valid combination, MagicKey will be
  141.           installed, and you will be informed of the scan codes of the
  142.           key combination. [ e.g. -K=10,30 ]. These scan codes can be used
  143.           to install MagicKey from a batch file so that it will use your
  144.           special hot key.
  145.  
  146.           Always make sure that the hot key combination you use is one that
  147.           the program will not need. 3 key combinations are best because
  148.           most programs don't use them for something else. Function keys
  149.           can also be used as hot keys.
  150.  
  151.           Once you know the scan code for the hot key you wish to use, you
  152.           can enter -K=nn,nn where nn,nn are the correct codes, to install
  153.           MagicKey. This is necessary when using a BAT file to install
  154.           MagicKey with a hotkey different from the default.
  155.  
  156. -t        Test mode. This argument should only be necessary if you are
  157. /T        having problems getting MagicKey to work. MagicKey will operate
  158.           as a regular program without creating a TSR. Autotyping is
  159.           disabled in test mode.  If MagicKey works in test mode, but
  160.           doesn't work as a TSR, the problem is likely a compatibility
  161.           problem with another TSR or driver on your system.  We would like
  162.           to hear about such problems, but we cannot promise to be able to
  163.           fix them. If you are having problems, please let us know if they
  164.           occur in test mode as well as in TSR mode.
  165.  
  166. -r        Remove MagicKey.  After MagicKey has been installed as a TSR, it
  167. /R        can be removed from the DOS command line by entering the command:
  168.           MAGICKEY -r. This is useful if you do not wish to use MagicKey
  169.           again and want to maximize your available conventional memory.
  170.           MagicKey can also be removed by pressing Alt-R after popping up
  171.           the MagicKey window with the hot keys.
  172.  
  173.           If another TSR has been loaded after MagicKey which uses the same
  174.           interrupts, MagicKey will delay unloading itself until the other
  175.